SGPanelGetDITL(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components / Sequence Grabber Panel Components Reference

Functions / Managing Your Panel Component

SGPanelGetDITL
The SGPanelGetDITL function allows a sequence grabber component to determine the dialog items managed by your panel component. The sequence grabber uses this information to build the sequence grabber settings dialog box for the user.
pascal ComponentResult SGPanelGetDITL (SeqGrabPanelComponent s,
                                        Handle *ditl);
s
Identifies the sequence grabber component's connection to your panel component.
ditl
Contains a pointer to a handle that is to receive your component's item list. Your component should resize this handle as appropriate.

DESCRIPTION
A sequence grabber component calls your SGPanelGetDITL function in order to obtain the list of dialog items supported by your panel component. The sequence grabber then places these items into the settings dialog box and presents the dialog box to the user. When the sequence grabber builds the settings dialog box, it places your items appropriately--you do not need to specify particular locations for the items.
Your component returns the item list in a handle that is provided by the sequence grabber component. Note that the sequence grabber component will dispose of this handle after retrieving the item list, so make sure that the item list is not stored in a resource. If your item list is in a resource handle, you can use the Resource Manager's DetachResource routine to convert that resource handle into a handle that is suitable for use with the SGPanelGetDITL function.
The sequence grabber component will open your resource file before calling this function unless you have instructed the sequence grabber component not to open your resource file (that is, you have set the channelFlagDontOpenResFile component flag to 1).